<!DOCTYPE html>
<html lang="zh" dir="ltr" class="client-nojs">
<head>
<title>用户定义字面量 (C++11 起)</title>
<meta charset="UTF-8">
<meta name="generator" content="MediaWiki 1.21.2">
<link rel="shortcut icon" href="../../../common/favicon.ico">
<link rel="stylesheet" href="../../../common/ext.css">
<meta name="ResourceLoaderDynamicStyles" content="">
<link rel="stylesheet" href="../../../common/site_modules.css">
<style>a:lang(ar),a:lang(ckb),a:lang(fa),a:lang(kk-arab),a:lang(mzn),a:lang(ps),a:lang(ur){text-decoration:none}#toc{display:none}.editsection{display:none}
/* cache key: mwiki1-mwiki_zh_:resourceloader:filter:minify-css:7:15cea3ec788a65b5187d4018eed543bf */</style>

<script src="../../../common/startup_scripts.js"></script>
<script>if(window.mw){
mw.config.set({"wgCanonicalNamespace":"","wgCanonicalSpecialPageName":false,"wgNamespaceNumber":0,"wgPageName":"cpp/language/user_literal","wgTitle":"cpp/language/user literal","wgCurRevisionId":60202,"wgArticleId":2765,"wgIsArticle":true,"wgAction":"view","wgUserName":null,"wgUserGroups":["*"],"wgCategories":[],"wgBreakFrames":false,"wgPageContentLanguage":"zh","wgSeparatorTransformTable":["",""],"wgDigitTransformTable":["",""],"wgDefaultDateFormat":"zh","wgMonthNames":["","1月","2月","3月","4月","5月","6月","7月","8月","9月","10月","11月","12月"],"wgMonthNamesShort":["","1月","2月","3月","4月","5月","6月","7月","8月","9月","10月","11月","12月"],"wgRelevantPageName":"cpp/language/user_literal","wgUserVariant":"zh","wgRestrictionEdit":[],"wgRestrictionMove":[]});
}</script><script>if(window.mw){
mw.loader.implement("user.options",function(){mw.user.options.set({"ccmeonemails":0,"cols":80,"date":"default","diffonly":0,"disablemail":0,"disablesuggest":0,"editfont":"default","editondblclick":0,"editsection":0,"editsectiononrightclick":0,"enotifminoredits":0,"enotifrevealaddr":0,"enotifusertalkpages":1,"enotifwatchlistpages":0,"extendwatchlist":0,"externaldiff":0,"externaleditor":0,"fancysig":0,"forceeditsummary":0,"gender":"unknown","hideminor":0,"hidepatrolled":0,"imagesize":2,"justify":0,"math":1,"minordefault":0,"newpageshidepatrolled":0,"nocache":0,"noconvertlink":0,"norollbackdiff":0,"numberheadings":0,"previewonfirst":0,"previewontop":1,"quickbar":5,"rcdays":7,"rclimit":50,"rememberpassword":0,"rows":25,"searchlimit":20,"showhiddencats":0,"showjumplinks":1,"shownumberswatching":1,"showtoc":0,"showtoolbar":1,"skin":"cppreference2","stubthreshold":0,"thumbsize":2,"underline":2,"uselivepreview":0,"usenewrc":0,"watchcreations":0,"watchdefault":0,"watchdeletion":0,
"watchlistdays":3,"watchlisthideanons":0,"watchlisthidebots":0,"watchlisthideliu":0,"watchlisthideminor":0,"watchlisthideown":0,"watchlisthidepatrolled":0,"watchmoves":0,"wllimit":250,"variant":"zh","language":"zh","searchNs0":true,"searchNs1":false,"searchNs2":false,"searchNs3":false,"searchNs4":false,"searchNs5":false,"searchNs6":false,"searchNs7":false,"searchNs8":false,"searchNs9":false,"searchNs10":false,"searchNs11":false,"searchNs12":false,"searchNs13":false,"searchNs14":false,"searchNs15":false,"gadget-MathJax":1,"gadget-ColiruCompiler":1});;},{},{});mw.loader.implement("user.tokens",function(){mw.user.tokens.set({"editToken":"+\\","patrolToken":false,"watchToken":false});;},{},{});
/* cache key: mwiki1-mwiki_zh_:resourceloader:filter:minify-js:7:258d7cd6aa9aa67dee25e01fb6a9e505 */
}</script>
<script>if(window.mw){
mw.loader.load(["mediawiki.page.startup","mediawiki.legacy.wikibits","mediawiki.legacy.ajax"]);
}</script>
<style type="text/css">/*<![CDATA[*/
.source-cpp {line-height: normal;}
.source-cpp li, .source-cpp pre {
	line-height: normal; border: 0px none white;
}
/**
 * GeSHi Dynamically Generated Stylesheet
 * --------------------------------------
 * Dynamically generated stylesheet for cpp
 * CSS class: source-cpp, CSS id: 
 * GeSHi (C) 2004 - 2007 Nigel McNie, 2007 - 2008 Benny Baumann
 * (http://qbnz.com/highlighter/ and http://geshi.org/)
 * --------------------------------------
 */
.cpp.source-cpp .de1, .cpp.source-cpp .de2 {font: normal normal 1em/1.2em monospace; margin:0; padding:0; background:none; vertical-align:top;}
.cpp.source-cpp  {font-family:monospace;}
.cpp.source-cpp .imp {font-weight: bold; color: red;}
.cpp.source-cpp li, .cpp.source-cpp .li1 {font-weight: normal; vertical-align:top;}
.cpp.source-cpp .ln {width:1px;text-align:right;margin:0;padding:0 2px;vertical-align:top;}
.cpp.source-cpp .li2 {font-weight: bold; vertical-align:top;}
.cpp.source-cpp .kw1 {color: #0000dd;}
.cpp.source-cpp .kw2 {color: #0000ff;}
.cpp.source-cpp .kw3 {color: #0000dd;}
.cpp.source-cpp .kw4 {color: #0000ff;}
.cpp.source-cpp .co1 {color: #909090;}
.cpp.source-cpp .co2 {color: #339900;}
.cpp.source-cpp .coMULTI {color: #ff0000; font-style: italic;}
.cpp.source-cpp .es0 {color: #008000; font-weight: bold;}
.cpp.source-cpp .es1 {color: #008000; font-weight: bold;}
.cpp.source-cpp .es2 {color: #008000; font-weight: bold;}
.cpp.source-cpp .es3 {color: #008000; font-weight: bold;}
.cpp.source-cpp .es4 {color: #008000; font-weight: bold;}
.cpp.source-cpp .es5 {color: #008000; font-weight: bold;}
.cpp.source-cpp .br0 {color: #008000;}
.cpp.source-cpp .sy0 {color: #008000;}
.cpp.source-cpp .sy1 {color: #000080;}
.cpp.source-cpp .sy2 {color: #000040;}
.cpp.source-cpp .sy3 {color: #000040;}
.cpp.source-cpp .sy4 {color: #008080;}
.cpp.source-cpp .st0 {color: #008000;}
.cpp.source-cpp .nu0 {color: #000080;}
.cpp.source-cpp .nu6 {color: #000080;}
.cpp.source-cpp .nu8 {color: #000080;}
.cpp.source-cpp .nu12 {color: #000080;}
.cpp.source-cpp .nu16 {color:#000080;}
.cpp.source-cpp .nu17 {color:#000080;}
.cpp.source-cpp .nu18 {color:#000080;}
.cpp.source-cpp .nu19 {color:#000080;}
.cpp.source-cpp .ln-xtra, .cpp.source-cpp li.ln-xtra, .cpp.source-cpp div.ln-xtra {background-color: #ffc;}
.cpp.source-cpp span.xtra { display:block; }

/*]]>*/
</style><style type="text/css">/*<![CDATA[*/
.source-text {line-height: normal;}
.source-text li, .source-text pre {
	line-height: normal; border: 0px none white;
}
/**
 * GeSHi Dynamically Generated Stylesheet
 * --------------------------------------
 * Dynamically generated stylesheet for text
 * CSS class: source-text, CSS id: 
 * GeSHi (C) 2004 - 2007 Nigel McNie, 2007 - 2008 Benny Baumann
 * (http://qbnz.com/highlighter/ and http://geshi.org/)
 * --------------------------------------
 */
.text.source-text .de1, .text.source-text .de2 {font: normal normal 1em/1.2em monospace; margin:0; padding:0; background:none; vertical-align:top;}
.text.source-text  {font-family:monospace;}
.text.source-text .imp {font-weight: bold; color: red;}
.text.source-text li, .text.source-text .li1 {font-weight: normal; vertical-align:top;}
.text.source-text .ln {width:1px;text-align:right;margin:0;padding:0 2px;vertical-align:top;}
.text.source-text .li2 {font-weight: bold; vertical-align:top;}
.text.source-text .ln-xtra, .text.source-text li.ln-xtra, .text.source-text div.ln-xtra {background-color: #ffc;}
.text.source-text span.xtra { display:block; }

/*]]>*/
</style><!--[if lt IE 7]><style type="text/css">body{behavior:url("/mwiki/skins/cppreference2/csshover.min.htc")}</style><![endif]--></head>
<body class="mediawiki ltr sitedir-ltr ns-0 ns-subject page-cpp_language_user_literal skin-cppreference2 action-view cpp-navbar">
        <!-- header -->
        <!-- /header -->
        <!-- content -->
<div id="cpp-content-base">
            <div id="content">
                <a id="top"></a>
                <div id="mw-js-message" style="display:none;"></div>
                                <!-- firstHeading -->
<h1 id="firstHeading" class="firstHeading">用户定义字面量 <span class="t-mark-rev t-since-cxx11">(C++11 起)</span></h1>
                <!-- /firstHeading -->
                <!-- bodyContent -->
                <div id="bodyContent">
                                        <!-- tagline -->
                    <div id="siteSub">来自cppreference.com</div>
                    <!-- /tagline -->
                                        <!-- subtitle -->
                    <div id="contentSub"><span class="subpages">&lt; <a href="../../cpp.html" title="cpp">cpp</a>‎ | <a href="../language.html" title="cpp/language">language</a></span></div>
                    <!-- /subtitle -->
                                                            <!-- bodycontent -->
                    <div id="mw-content-text" lang="zh" dir="ltr" class="mw-content-ltr"><div class="t-navbar" style=""><div class="t-navbar-sep"> </div><div class="t-navbar-head"><a href="../../cpp.html" title="cpp"> C++</a><div class="t-navbar-menu"><div><div><table class="t-nv-begin" cellpadding="0" style="line-height:1.1em;">
<tr class="t-nv"><td colspan="5"> <a href="../language.html" title="cpp/language">语言</a> </td></tr>
<tr class="t-nv"><td colspan="5"> <a href="../header.html" title="cpp/header">标准库头文件</a> </td></tr>
<tr class="t-nv"><td colspan="5"> <a href="../freestanding.html" title="cpp/freestanding"> 自立与有宿主实现</a> </td></tr>
<tr class="t-nv"><td colspan="5"> <a href="../named_req.html" title="cpp/named req">具名要求</a> </td></tr>
<tr class="t-nv"><td colspan="5"> <a href="../utility.html#.E8.AF.AD.E8.A8.80.E6.94.AF.E6.8C.81" title="cpp/utility">语言支持库</a> </td></tr>
<tr class="t-nv"><td colspan="5"> <a href="../concepts.html" title="cpp/concepts">概念库</a> <span class="t-mark-rev t-since-cxx20">(C++20)</span> </td></tr>
<tr class="t-nv"><td colspan="5"> <a href="../error.html" title="cpp/error">诊断库</a> </td></tr>
<tr class="t-nv"><td colspan="5"> <a href="../utility.html" title="cpp/utility">工具库</a> </td></tr>
<tr class="t-nv"><td colspan="5"> <a href="../string.html" title="cpp/string">字符串库</a> </td></tr>
<tr class="t-nv"><td colspan="5"> <a href="https://zh.cppreference.com/w/cpp/container" title="cpp/container">容器库</a> </td></tr>
<tr class="t-nv"><td colspan="5"> <a href="../iterator.html" title="cpp/iterator">迭代器库</a> </td></tr>
<tr class="t-nv"><td colspan="5"> <a href="../ranges.html" title="cpp/ranges"> 范围库</a> <span class="t-mark-rev t-since-cxx20">(C++20)</span> </td></tr>
<tr class="t-nv"><td colspan="5"> <a href="../algorithm.html" title="cpp/algorithm">算法库</a> </td></tr>
<tr class="t-nv"><td colspan="5"> <a href="../numeric.html" title="cpp/numeric">数值库</a> </td></tr>
<tr class="t-nv"><td colspan="5"> <a href="../io.html" title="cpp/io">输入/输出库</a> </td></tr>
<tr class="t-nv"><td colspan="5"> <a href="../locale.html" title="cpp/locale">本地化库</a> </td></tr>
<tr class="t-nv"><td colspan="5"> <a href="../regex.html" title="cpp/regex">正则表达式库</a> <span class="t-mark-rev t-since-cxx11">(C++11)</span> </td></tr>
<tr class="t-nv"><td colspan="5"> <a href="../atomic.html" title="cpp/atomic">原子操作库</a> <span class="t-mark-rev t-since-cxx11">(C++11)</span> </td></tr>
<tr class="t-nv"><td colspan="5"> <a href="../thread.html" title="cpp/thread">线程支持库</a> <span class="t-mark-rev t-since-cxx11">(C++11)</span> </td></tr>
<tr class="t-nv"><td colspan="5"> <a href="../filesystem.html" title="cpp/filesystem">文件系统库</a> <span class="t-mark-rev t-since-cxx17">(C++17)</span> </td></tr>
<tr class="t-nv"><td colspan="5"> <a href="../experimental.html" title="cpp/experimental">技术规范</a> </td></tr>
</table></div><div></div></div></div></div><div class="t-navbar-sep"> </div><div class="t-navbar-head"><a href="../language.html" title="cpp/language">C++ 语言</a></div><div class="t-navbar-sep"> </div><div class="t-navbar-head"><a href="expressions.html" title="cpp/language/expressions"> 表达式</a><div class="t-navbar-menu"><div><div style="display:inline-block">
<div><table class="t-nv-begin" cellpadding="0" style="">
<tr class="t-nv-h2"><td colspan="5"> 概述 </td></tr>
<tr class="t-nv"><td colspan="5"> <a href="value_category.html" title="cpp/language/value category"> 值类别</a>（左值 lvalue、右值 rvalue、亡值 xvalue）</td></tr>
<tr class="t-nv"><td colspan="5"> <a href="eval_order.html" title="cpp/language/eval order"> 求值顺序</a>（序列点）</td></tr>
<tr class="t-nv"><td colspan="5"> <a href="constant_expression.html" title="cpp/language/constant expression"> 常量表达式</a></td></tr>
<tr class="t-nv"><td colspan="5"> <a href="expressions.html#.E4.B8.8D.E6.B1.82.E5.80.BC.E8.A1.A8.E8.BE.BE.E5.BC.8F" title="cpp/language/expressions"> 不求值表达式</a></td></tr>
<tr class="t-nv"><td colspan="5"> <a href="expressions.html#.E5.88.9D.E7.AD.89.E8.A1.A8.E8.BE.BE.E5.BC.8F" title="cpp/language/expressions"> 初等表达式</a></td></tr>
<tr class="t-nv"><td colspan="5"> <a href="lambda.html" title="cpp/language/lambda">lambda 表达式</a><span class="t-mark-rev t-since-cxx11">(C++11)</span></td></tr>
<tr class="t-nv-h2"><td colspan="5"> 字面量 </td></tr>
<tr class="t-nv"><td colspan="5"> <a href="integer_literal.html" title="cpp/language/integer literal">整数字面量</a></td></tr>
<tr class="t-nv"><td colspan="5"> <a href="floating_literal.html" title="cpp/language/floating literal">浮点字面量</a></td></tr>
<tr class="t-nv"><td colspan="5"> <a href="bool_literal.html" title="cpp/language/bool literal">布尔字面量</a></td></tr>
<tr class="t-nv"><td colspan="5"> <a href="character_literal.html" title="cpp/language/character literal">字符字面量</a>，包含<a href="escape.html" title="cpp/language/escape">转义序列</a></td></tr>
<tr class="t-nv"><td colspan="5"> <a href="string_literal.html" title="cpp/language/string literal">字符串字面量</a></td></tr>
<tr class="t-nv"><td colspan="5"> <a href="nullptr.html" title="cpp/language/nullptr">空指针字面量</a><span class="t-mark-rev t-since-cxx11">(C++11)</span></td></tr>
<tr class="t-nv"><td colspan="5"> <strong class="selflink">用户定义字面量</strong><span class="t-mark-rev t-since-cxx11">(C++11)</span></td></tr>
<tr class="t-nv-h2"><td colspan="5"> 运算符 </td></tr>
<tr class="t-nv"><td colspan="5"> <a href="operator_assignment.html" title="cpp/language/operator assignment"> 赋值运算符</a>:
<code>a=b</code>, <code>a+=b</code>, <code>a-=b</code>, <code>a*=b</code>, <code>a/=b</code>, <code>a%=b</code>, <code>a&amp;=b</code>, <code>a|=b</code>, <code>a^=b</code>, <code>a&lt;&lt;=b</code>, <code>a&gt;&gt;=b</code></td></tr>
<tr class="t-nv"><td colspan="5"> <a href="operator_incdec.html" title="cpp/language/operator incdec"> 自增与自减</a>: <code>++a</code>, <code>--a</code>, <code>a++</code>, <code>a--</code></td></tr>
<tr class="t-nv"><td colspan="5"> <a href="operator_arithmetic.html" title="cpp/language/operator arithmetic"> 算术运算符</a>:
<code>+a</code>, <code>-a</code>, <code>a+b</code>, <code>a-b</code>, <code>a*b</code>, <code>a/b</code>, <code>a%b</code>, <code>~a</code>, <code>a&amp;b</code>, <code>a|b</code>, <code>a^b</code>, <code>a&lt;&lt;b</code>, <code>a&gt;&gt;b</code> </td></tr>
<tr class="t-nv"><td colspan="5"> <a href="operator_logical.html" title="cpp/language/operator logical"> 逻辑运算符</a>: <code>a||b</code>, <code>a&amp;&amp;b</code>, <code>!a</code></td></tr>
<tr class="t-nv"><td colspan="5"> <a href="operator_comparison.html" title="cpp/language/operator comparison"> 比较运算符</a>: <code>a==b</code>, <code>a!=b</code>, <code>a&lt;b</code>, <code>a&gt;b</code>, <code>a&lt;=b</code>, <code>a&gt;=b</code>, <code>a&lt;=&gt;b</code><span class="t-mark-rev t-since-cxx20">(C++20)</span></td></tr>
<tr class="t-nv"><td colspan="5"> <a href="operator_member_access.html" title="cpp/language/operator member access"> 成员访问运算符</a>: <code>a[b]</code>, <code>*a</code>, <code>&amp;a</code>, <code>a-&gt;b</code>, <code>a.b</code>, <code>a-&gt;*b</code>, <code>a.*b</code></td></tr>
<tr class="t-nv"><td colspan="5"> <a href="operator_other.html" title="cpp/language/operator other"> 其他运算符</a>: <code>a(...)</code>, <code>a,b</code>, <code>a?b:c</code> </td></tr>
<tr class="t-nv"><td colspan="5"> <a href="default_comparisons.html" title="cpp/language/default comparisons">默认比较</a><span class="t-mark-rev t-since-cxx20">(C++20)</span></td></tr>
<tr class="t-nv"><td colspan="5"> <a href="operator_alternative.html" title="cpp/language/operator alternative">运算符的代用表示</a></td></tr>
<tr class="t-nv"><td colspan="5"> <a href="operator_precedence.html" title="cpp/language/operator precedence">优先级和结合性</a></td></tr>
<tr class="t-nv"><td colspan="5"> <a href="fold.html" title="cpp/language/fold">折叠表达式</a><span class="t-mark-rev t-since-cxx17">(C++17)</span></td></tr>
<tr class="t-nv"><td colspan="5"> <a href="new.html" title="cpp/language/new">new 表达式</a></td></tr>
<tr class="t-nv"><td colspan="5"> <a href="delete.html" title="cpp/language/delete">delete 表达式</a></td></tr>
<tr class="t-nv"><td colspan="5"> <a href="throw.html" title="cpp/language/throw">throw 表达式</a></td></tr>
<tr class="t-nv"><td colspan="5"> <a href="alignof.html" title="cpp/language/alignof">alignof</a></td></tr>
<tr class="t-nv"><td colspan="5"> <a href="sizeof.html" title="cpp/language/sizeof">sizeof</a></td></tr>
<tr class="t-nv"><td colspan="5"> <a href="sizeof....html" title="cpp/language/sizeof...">sizeof...</a><span class="t-mark-rev t-since-cxx11">(C++11)</span></td></tr>
<tr class="t-nv"><td colspan="5"> <a href="typeid.html" title="cpp/language/typeid">typeid</a></td></tr>
<tr class="t-nv"><td colspan="5"> <a href="noexcept.html" title="cpp/language/noexcept">noexcept</a><span class="t-mark-rev t-since-cxx11">(C++11)</span></td></tr>
<tr class="t-nv"><td colspan="5"> <a href="operators.html" title="cpp/language/operators">运算符重载</a></td></tr>
<tr class="t-nv-h2"><td colspan="5"> 类型转换 </td></tr>
<tr class="t-nv"><td colspan="5"> <a href="implicit_cast.html" title="cpp/language/implicit conversion">隐式转换</a></td></tr>
<tr class="t-nv"><td colspan="5"> <a href="const_cast.html" title="cpp/language/const cast">const_cast</a></td></tr>
<tr class="t-nv"><td colspan="5"> <a href="static_cast.html" title="cpp/language/static cast">static_cast</a></td></tr>
<tr class="t-nv"><td colspan="5"> <a href="reinterpret_cast.html" title="cpp/language/reinterpret cast">reinterpret_cast</a></td></tr>
<tr class="t-nv"><td colspan="5"> <a href="dynamic_cast.html" title="cpp/language/dynamic cast">dynamic_cast</a></td></tr>
<tr class="t-nv"><td colspan="5"> <a href="explicit_cast.html" title="cpp/language/explicit cast">显式转换</a> <code>(T)a</code>, <code>T(a)</code></td></tr>
<tr class="t-nv"><td colspan="5"> <a href="cast_operator.html" title="cpp/language/cast operator">用户定义转换</a></td></tr>
</table></div>
</div><div></div></div></div></div><div class="t-navbar-sep"> </div></div>
<p>通过定义用户定义的后缀，允许整数、浮点数、字符及字符串字面量产生用户定义类型的对象。
</p>
<h3><span class="mw-headline" id=".E8.AF.AD.E6.B3.95">语法</span></h3>
<p>用户定义字面量是下列形式的表达式之一
</p>
<table class="t-sdsc-begin">

<tr>
<td colspan="10" class="t-sdsc-sep">
</td></tr>
<tr class="t-sdsc">
<td> <span class="t-spar">十进制字面量</span> <span class="t-spar">ud-后缀</span>
</td>
<td> (1)
</td>
<td class="t-sdsc-nopad">
</td></tr>



<tr>
<td colspan="10" class="t-sdsc-sep">
</td></tr>
<tr class="t-sdsc">
<td> <span class="t-spar">八进制字面量</span> <span class="t-spar">ud-后缀</span>
</td>
<td> (2)
</td>
<td class="t-sdsc-nopad">
</td></tr>



<tr>
<td colspan="10" class="t-sdsc-sep">
</td></tr>
<tr class="t-sdsc">
<td> <span class="t-spar">十六进制字面量</span> <span class="t-spar">ud-后缀</span>
</td>
<td> (3)
</td>
<td class="t-sdsc-nopad">
</td></tr>



<tr>
<td colspan="10" class="t-sdsc-sep">
</td></tr>
<tr class="t-sdsc">
<td> <span class="t-spar">二进制字面量</span> <span class="t-spar">ud-后缀</span>
</td>
<td> (4)
</td>
<td class="t-sdsc-nopad">
</td></tr>



<tr>
<td colspan="10" class="t-sdsc-sep">
</td></tr>
<tr class="t-sdsc">
<td> <span class="t-spar">分数常量</span> <span class="t-spar">指数部分</span><span class="t-mark">(可选)</span> <span class="t-spar">ud-后缀</span>
</td>
<td> (5)
</td>
<td class="t-sdsc-nopad">
</td></tr>



<tr>
<td colspan="10" class="t-sdsc-sep">
</td></tr>
<tr class="t-sdsc">
<td> <span class="t-spar">数字序列</span> <span class="t-spar">指数部分</span> <span class="t-spar">ud-后缀</span>
</td>
<td> (6)
</td>
<td class="t-sdsc-nopad">
</td></tr>



<tr>
<td colspan="10" class="t-sdsc-sep">
</td></tr>
<tr class="t-sdsc">
<td> <span class="t-spar">字符字面量</span> <span class="t-spar">ud-后缀</span>
</td>
<td> (7)
</td>
<td class="t-sdsc-nopad">
</td></tr>



<tr>
<td colspan="10" class="t-sdsc-sep">
</td></tr>
<tr class="t-sdsc">
<td> <span class="t-spar">字符串字面量</span> <span class="t-spar">ud-后缀</span>
</td>
<td> (8)
</td>
<td class="t-sdsc-nopad">
</td></tr>



<tr>
<td colspan="10" class="t-sdsc-sep">
</td></tr></table>
<div class="t-li1"><span class="t-li">1-4)</span> 用户定义整数字面量，例如 <span class="t-c"><span class="mw-geshi cpp source-cpp"><span class="nu0">12</span>_km</span></span></div>
<div class="t-li1"><span class="t-li">5-6)</span> 用户定义浮点字面量，例如 <span class="t-c"><span class="mw-geshi cpp source-cpp"><span class="nu16">0.5</span>_Pa</span></span></div>
<div class="t-li1"><span class="t-li">7)</span> 用户定义字符字面量，例如 <span class="t-c"><span class="mw-geshi cpp source-cpp"><span class="st0">'c'</span>_X</span></span></div>
<div class="t-li1"><span class="t-li">8)</span> 用户定义字符串字面量，例如 <span class="t-c"><span class="mw-geshi cpp source-cpp"><span class="st0">"abd"</span>_L</span></span> 或 <span class="t-c"><span class="mw-geshi cpp source-cpp">u<span class="st0">"xyz"</span>_M</span></span></div>
<table class="t-par-begin">


<tr class="t-par">
<td>  <span class="t-spar">十进制字面量</span>
</td>
<td> -
</td>
<td>  与<a href="integer_literal.html" title="cpp/language/integer literal">整数字面量</a>中相同，非零的十进制数位后随零或多个十进制数位
</td></tr>
<tr class="t-par">
<td>  <span class="t-spar">八进制字面量</span>
</td>
<td> -
</td>
<td>  与<a href="integer_literal.html" title="cpp/language/integer literal">整数字面量</a>中相同，零后随零或多个八进制数位
</td></tr>
<tr class="t-par">
<td>  <span class="t-spar">十六进制字面量</span>
</td>
<td> -
</td>
<td>  与<a href="integer_literal.html" title="cpp/language/integer literal">整数字面量</a>中相同，<code>0x</code> 或 <code>0X</code> 后随一个或多个十六进制数位
</td></tr>
<tr class="t-par">
<td>  <span class="t-spar">二进制字面量</span>
</td>
<td> -
</td>
<td>  与<a href="integer_literal.html" title="cpp/language/integer literal">整数字面量</a>中相同，<code>0b</code> 或 <code>0B</code> 后随一或多个二进制数位
</td></tr>
<tr class="t-par">
<td>  <span class="t-spar">数字序列</span>
</td>
<td> -
</td>
<td>  与<a href="floating_literal.html" title="cpp/language/floating literal">浮点字面量</a>中相同，一个十进制数字序列
</td></tr>
<tr class="t-par">
<td>  <span class="t-spar">分数常量</span>
</td>
<td> -
</td>
<td>  与<a href="floating_literal.html" title="cpp/language/floating literal">浮点字面量</a>中相同，要么是一个后随小数点的 <span class="t-spar">字符序列</span>（<span class="t-c"><span class="mw-geshi cpp source-cpp"><span class="nu0">123</span>.</span></span>），要么是一个可选的 <span class="t-spar">字符序列</span> 后随小数点和另一个 <span class="t-spar">字符序列</span>（<span class="t-c"><span class="mw-geshi cpp source-cpp"><span class="nu16">1.0</span></span></span> 或 <span class="t-c"><span class="mw-geshi cpp source-cpp"><span class="nu18">.12</span></span></span>）
</td></tr>
<tr class="t-par">
<td>  <span class="t-spar">指数部分</span>
</td>
<td> -
</td>
<td>  与<a href="floating_literal.html" title="cpp/language/floating literal">浮点字面量</a>中相同，字母 <code>e</code> 或字母 <code>E</code> 后随可选的正负号，后随 <span class="t-spar">字符序列</span>
</td></tr>
<tr class="t-par">
<td>  <span class="t-spar">字符字面量</span>
</td>
<td> -
</td>
<td>  与<a href="character_literal.html" title="cpp/language/character literal">字符字面量</a>中相同
</td></tr>
<tr class="t-par">
<td>  <span class="t-spar">字符串字面量</span>
</td>
<td> -
</td>
<td>  与<a href="string_literal.html" title="cpp/language/string literal">字符串字面量</a>中相同，包括原始字符串字面量
</td></tr>
<tr class="t-par">
<td>  <span class="t-spar">ud-后缀</span>
</td>
<td> -
</td>
<td>  标识符，由<i>字面量运算符</i>或<i>字面量运算符模板</i>声明引入（见下文）。所有程序引入的 <span class="t-spar">ud-后缀</span> 必须以下划线字符 <code><b>_</b></code> 开始。标准库的 <span class="t-spar">ud-后缀</span> 不以下划线开始。
</td></tr></table>
 <table class="t-rev-begin">
<tr class="t-rev t-since-cxx14"><td>
<p>在整数和浮点字符序列中，允许在任何两个数位间插入可选的分隔符 <code><b>'</b></code>，并忽略它们。
</p>
</td>
<td><span class="t-mark-rev t-since-cxx14">(C++14 起)</span></td></tr>
</table>
<p>若一个记号同时匹配用户定义字面量的语法和常规字面量的语法，则它被假定为常规字面量（即不可能重载 <span class="t-c"><span class="mw-geshi cpp source-cpp">123LL</span></span> 中的 <span class="t-c"><span class="mw-geshi cpp source-cpp">LL</span></span>）
</p><p>当编译器遇到一个带有 <span class="t-spar">ud-后缀</span> <code>X</code> 的用户定义字面量时，它进行<a href="unqualified_lookup.html" title="cpp/language/unqualified lookup">无限定名字查找</a>，寻找名为 <code>operator "" X</code> 的函数。若找不到任何声明，则程序非良构。否则，
</p>
<div class="t-li1"><span class="t-li">1)</span> 对于用户定义整数字面量</div>
<div class="t-li2"><span class="t-li">a)</span> 若重载集包含带有形参类型 <span class="t-c"><span class="mw-geshi cpp source-cpp"><span class="kw4">unsigned</span> <span class="kw4">long</span> <span class="kw4">long</span></span></span> 的字面量运算符，则用户定义字面量表达式被当做函数调用 <span class="t-c"><span class="mw-geshi cpp source-cpp">operator <span class="st0">""</span> X<span class="br0">(</span>nULL<span class="br0">)</span></span></span>，其中 n 是无 <span class="t-spar">ud-后缀</span> 的字面量</div>
<div class="t-li2"><span class="t-li">b)</span> 否则，重载集必须包含以下之一，但不是二者：原始字面量运算符或数值字面量运算符模板。若重载集包含原始字面量运算符，则用户定义字面量表达式被当做函数调用 <span class="t-c"><span class="mw-geshi cpp source-cpp">operator <span class="st0">""</span> X<span class="br0">(</span><span class="st0">"n"</span><span class="br0">)</span></span></span></div>
<div class="t-li2"><span class="t-li">c)</span> 否则，若重载集包含数值字面量运算符模板，则用户定义字面量表达式被当做函数调用 <span class="t-c"><span class="mw-geshi cpp source-cpp">operator <span class="st0">""</span> X<span class="sy1">&lt;</span><span class="st0">'c1'</span>, <span class="st0">'c2'</span>, <span class="st0">'c3'</span>..., <span class="st0">'ck'</span><span class="sy1">&gt;</span><span class="br0">(</span><span class="br0">)</span></span></span>，其中 c1..ck 是 <code>n</code> 中的各个字符。</div>
<div class="t-li1"><span class="t-li">2)</span> 对于用户定义浮点字面量，</div>
<div class="t-li2"><span class="t-li">a)</span> 若重载集包含带有形参类型 <span class="t-c"><span class="mw-geshi cpp source-cpp"><span class="kw4">long</span> <span class="kw4">double</span></span></span> 的字面量运算符，则用户定义字面量表达式被当做函数调用 <span class="t-c"><span class="mw-geshi cpp source-cpp">operator <span class="st0">""</span> X<span class="br0">(</span>fL<span class="br0">)</span></span></span>，其中 <code>f</code> 是无 <span class="t-spar">ud-后缀</span> 的字面量</div>
<div class="t-li2"><span class="t-li">b)</span> 否则，重载集必须包含下列之一，但不是二者：原始字面量运算符或数值字面量运算符模板。若重载集包含原始字面量运算符，则用户定义字面量表达式被当做函数调用 <span class="t-c"><span class="mw-geshi cpp source-cpp">operator <span class="st0">""</span> X<span class="br0">(</span><span class="st0">"f"</span><span class="br0">)</span></span></span></div>
<div class="t-li2"><span class="t-li">c)</span> 否则，若重载集包含数值字面量运算符模板，则用户定义字面量表达式被当做函数调用 <span class="t-c"><span class="mw-geshi cpp source-cpp">operator <span class="st0">""</span> X<span class="sy1">&lt;</span><span class="st0">'c1'</span>, <span class="st0">'c2'</span>, <span class="st0">'c3'</span>..., <span class="st0">'ck'</span><span class="sy1">&gt;</span><span class="br0">(</span><span class="br0">)</span></span></span>，其中 c1..ck 是 <code>f</code> 中的各个字符。</div>
<div class="t-li1"><span class="t-li">3)</span> 对于用户定义字符串字面量，令 <code>str</code> 为无 <span class="t-spar">ud-后缀</span> 的字面量：</div>
 <table class="t-rev-begin">
<tr class="t-rev t-since-cxx20"><td>
<div class="t-li2"><span class="t-li">a)</span> 若重载集包含带非类型模板形参的字符串字面量运算符模板，且 <code>str</code> 对它是良构的模板实参，则用户定义字面量表达式被当作函数调用 <span class="t-c"><span class="mw-geshi cpp source-cpp">operator <span class="st0">""</span> X<span class="sy1">&lt;</span>str<span class="sy1">&gt;</span><span class="br0">(</span><span class="br0">)</span></span></span>，
</div></td>
<td><span class="t-mark-rev t-since-cxx20">(C++20 起)</span></td></tr>
</table>
<div class="t-li2"><span class="t-li">b)</span> 否则，用户定义字面量表达式被当做函数调用 <span class="t-c"><span class="mw-geshi cpp source-cpp">operator <span class="st0">""</span> X <span class="br0">(</span>str, len<span class="br0">)</span></span></span>，其中 <code>len</code> 是字符串字面量的长度，不包含终止空字符</div>
<div class="t-li1"><span class="t-li">4)</span> 对于用户定义字符字面量，用户定义字面量表达式被当做函数调用 <span class="t-c"><span class="mw-geshi cpp source-cpp">operator <span class="st0">""</span> X <span class="br0">(</span>ch<span class="br0">)</span></span></span>，其中 <code>ch</code> 是无 <span class="t-spar">ud-后缀</span> 的字面量</div>
<div dir="ltr" class="mw-geshi" style="text-align: left;"><div class="cpp source-cpp"><pre class="de1"><span class="kw4">long</span> <span class="kw4">double</span> operator <span class="st0">""</span> _w<span class="br0">(</span><span class="kw4">long</span> <span class="kw4">double</span><span class="br0">)</span><span class="sy4">;</span>
<a href="../string/basic_string.html"><span class="kw1230">std::<span class="me2">string</span></span></a> operator <span class="st0">""</span> _w<span class="br0">(</span><span class="kw4">const</span> <span class="kw4">char16_t</span><span class="sy2">*</span>, size_t<span class="br0">)</span><span class="sy4">;</span>
<span class="kw4">unsigned</span> operator <span class="st0">""</span> _w<span class="br0">(</span><span class="kw4">const</span> <span class="kw4">char</span><span class="sy2">*</span><span class="br0">)</span><span class="sy4">;</span>
<span class="kw4">int</span> main<span class="br0">(</span><span class="br0">)</span> <span class="br0">{</span>
    <span class="nu16">1.2</span>_w<span class="sy4">;</span> <span class="co1">// 调用运算符 "" _w(1.2L)</span>
    u<span class="st0">"one"</span>_w<span class="sy4">;</span> <span class="co1">// 调用运算符 "" _w(u"one", 3)</span>
    <span class="nu0">12</span>_w<span class="sy4">;</span> <span class="co1">// 调用运算符 "" _w("12")</span>
    <span class="st0">"two"</span>_w<span class="sy4">;</span> <span class="co1">// 错误：无适用的字面量运算符</span>
<span class="br0">}</span></pre></div></div>
<p>当在<a href="translation_phases.html" title="cpp/language/translation phases">翻译阶段 6</a> 中发生字符串字面量的拼接时，用户定义字符串字面量也被拼接，且其 <span class="t-spar">ud-后缀</span> 在拼接时被忽略，但所有被拼接的字面量中只可以出现一个后缀：
</p>
<div dir="ltr" class="mw-geshi" style="text-align: left;"><div class="cpp source-cpp"><pre class="de1"><span class="kw4">int</span> main<span class="br0">(</span><span class="br0">)</span> <span class="br0">{</span>
    L<span class="st0">"A"</span> <span class="st0">"B"</span> <span class="st0">"C"</span>_x<span class="sy4">;</span> <span class="co1">// OK：同 L"ABC"_x</span>
    <span class="st0">"P"</span>_x <span class="st0">"Q"</span> <span class="st0">"R"</span>_y<span class="sy4">;</span><span class="co1">// 错误：二个不同的 ud-后缀（_x 与 _y）</span>
<span class="br0">}</span></pre></div></div>
<h3><span class="mw-headline" id=".E5.AD.97.E9.9D.A2.E9.87.8F.E8.BF.90.E7.AE.97.E7.AC.A6">字面量运算符</span></h3>
<p>用户定义字面量所调用的函数被称为<i>字面量运算符</i>（或若它是模板，则被称为<i>字面量运算符模板</i>）。它的声明恰如任何其他命名空间作用域的<a href="function.html" title="cpp/language/function">函数</a>或<a href="function_template.html" title="cpp/language/function template">函数模板</a>一样（它可以是友元函数、函数模板的显式实例化或特化，或通过 using 声明引入），但有下列限制：
</p><p>此函数的名称可拥有两种形式之一：
</p>
<table class="t-sdsc-begin">

<tr>
<td colspan="10" class="t-sdsc-sep">
</td></tr>
<tr class="t-sdsc">
<td class="t-sdsc-nopad"> <code><b>operator</b></code> <code><b>""</b></code> <span class="t-spar">标识符</span>
</td>
<td class="t-sdsc-nopad">
</td>
<td class="t-sdsc-nopad">
</td></tr>



<tr>
<td colspan="10" class="t-sdsc-sep">
</td></tr>
<tr class="t-sdsc">
<td class="t-sdsc-nopad"> <code><b>operator</b></code> <span class="t-spar">用户定义字符串字面量</span> <span class="t-mark-rev t-since-cxx14">(C++14 起)</span>
</td>
<td class="t-sdsc-nopad">
</td>
<td class="t-sdsc-nopad">
</td></tr>

 

<tr>
<td colspan="10" class="t-sdsc-sep">
</td></tr></table>
<table class="t-par-begin">


<tr class="t-par">
<td>  <span class="t-spar">标识符</span>
</td>
<td> -
</td>
<td>  作为用户定义字面量所用的 <span class="t-spar">ud-后缀</span> 的标识符，其将调用此函数。必须以下划线 <code><b>_</b></code> 开始：不以下划线开始的后缀为标准库提供的字面量运算符所保留。
</td></tr>
<tr class="t-par">
<td>  <span class="t-spar">用户定义字符串字面量</span>
</td>
<td> -
</td>
<td>  字符序列 <code><b>""</b></code> 后不带空格，后随将作为 <span class="t-spar">ud-后缀</span> 的字符序列。这种特殊语法使得将语言关键词和<a href="../keywords.html" title="cpp/keywords" class="mw-redirect">保留标识符</a>用作 <span class="t-spar">ud-后缀</span> 成为可能，并由来自头文件 <span class="t-c"><span class="mw-geshi cpp source-cpp"><span class="sy1">&lt;</span>complex<span class="sy1">&gt;</span></span></span> 的 <span class="t-c"><span class="mw-geshi cpp source-cpp">operator <span class="st0">""</span><span class="kw1">if</span></span></span> 的声明所用。注意，使用此形式不改变用户定义字面量必须以下划线开始的规则：类似 <span class="t-c"><span class="mw-geshi cpp source-cpp">operator <span class="st0">""</span><span class="kw1">if</span></span></span> 的声明只可出现作标准库头文及的一部分。然而，它允许下划线后随大写字母的用法（其他情况下这是<a href="name.html" title="cpp/language/identifiers">保留标识符</a>）。
</td></tr></table>
<p>若字面量运算符是模板，则它必须有空形参列表，而且只能有一个模板形参，模板形参必须是元素类型为 <span class="t-c"><span class="mw-geshi cpp source-cpp"><span class="kw4">char</span></span></span> 的非类型模板形参包（该情况下称之为<i>数值字面量运算符模板</i>）
</p>
<div dir="ltr" class="mw-geshi" style="text-align: left;"><div class="cpp source-cpp"><pre class="de1"><span class="kw1">template</span> <span class="sy1">&lt;</span><span class="kw4">char</span>...<span class="sy1">&gt;</span> <span class="kw4">double</span> operator <span class="st0">""</span> _x<span class="br0">(</span><span class="br0">)</span><span class="sy4">;</span></pre></div></div>
 <table class="t-rev-begin">
<tr class="t-rev t-since-cxx20"><td>
<p>或类类型的非类型模板形参（该情况下称之为<i>字符串字面量运算符模板</i>）
</p>
<div dir="ltr" class="mw-geshi" style="text-align: left;"><div class="cpp source-cpp"><pre class="de1"><span class="kw1">struct</span> A <span class="br0">{</span> A<span class="br0">(</span><span class="kw4">const</span> <span class="kw4">char</span> <span class="sy2">*</span><span class="br0">)</span><span class="sy4">;</span> <span class="kw4">auto</span> operator<span class="sy1">&lt;=&gt;</span><span class="br0">(</span><span class="kw4">const</span> A<span class="sy3">&amp;</span><span class="br0">)</span> <span class="kw4">const</span> <span class="sy1">=</span> <span class="kw1">default</span><span class="sy4">;</span> <span class="br0">}</span><span class="sy4">;</span>
 
<span class="kw1">template</span><span class="sy1">&lt;</span>A a<span class="sy1">&gt;</span> A operator <span class="st0">""</span>_a<span class="br0">(</span><span class="br0">)</span><span class="sy4">;</span></pre></div></div>
</td>
<td><span class="t-mark-rev t-since-cxx20">(C++20 起)</span></td></tr>
</table>
<p>字面量运算符仅允许下列形参列表：
</p>
<table class="t-sdsc-begin">

<tr>
<td colspan="10" class="t-sdsc-sep">
</td></tr>
<tr class="t-sdsc">
<td> <code><b>(</b></code> <span class="t-c"><span class="mw-geshi cpp source-cpp"><span class="kw4">const</span> <span class="kw4">char</span> <span class="sy2">*</span></span></span> <code><b>)</b></code>
</td>
<td> (1)
</td>
<td class="t-sdsc-nopad">
</td></tr>



<tr>
<td colspan="10" class="t-sdsc-sep">
</td></tr>
<tr class="t-sdsc">
<td> <code><b>(</b></code> <span class="t-c"><span class="mw-geshi cpp source-cpp"><span class="kw4">unsigned</span> <span class="kw4">long</span> <span class="kw4">long</span> <span class="kw4">int</span></span></span> <code><b>)</b></code>
</td>
<td> (2)
</td>
<td class="t-sdsc-nopad">
</td></tr>



<tr>
<td colspan="10" class="t-sdsc-sep">
</td></tr>
<tr class="t-sdsc">
<td> <code><b>(</b></code> <span class="t-c"><span class="mw-geshi cpp source-cpp"><span class="kw4">long</span> <span class="kw4">double</span></span></span> <code><b>)</b></code>
</td>
<td> (3)
</td>
<td class="t-sdsc-nopad">
</td></tr>



<tr>
<td colspan="10" class="t-sdsc-sep">
</td></tr>
<tr class="t-sdsc">
<td> <code><b>(</b></code> <span class="t-c"><span class="mw-geshi cpp source-cpp"><span class="kw4">char</span></span></span> <code><b>)</b></code>
</td>
<td> (4)
</td>
<td class="t-sdsc-nopad">
</td></tr>



<tr>
<td colspan="10" class="t-sdsc-sep">
</td></tr>
<tr class="t-sdsc">
<td> <code><b>(</b></code> <span class="t-c"><span class="mw-geshi cpp source-cpp"><span class="kw4">wchar_t</span></span></span> <code><b>)</b></code>
</td>
<td> (5)
</td>
<td class="t-sdsc-nopad">
</td></tr>



<tr>
<td colspan="10" class="t-sdsc-sep">
</td></tr>
<tr class="t-sdsc">
<td> <code><b>(</b></code> <span class="t-c"><span class="mw-geshi cpp source-cpp">char8_t</span></span> <code><b>)</b></code>
</td>
<td> (6)
</td>
<td> <span class="t-mark-rev t-since-cxx20">(C++20 起)</span>
</td></tr>



<tr>
<td colspan="10" class="t-sdsc-sep">
</td></tr>
<tr class="t-sdsc">
<td> <code><b>(</b></code> <span class="t-c"><span class="mw-geshi cpp source-cpp"><span class="kw4">char16_t</span></span></span> <code><b>)</b></code>
</td>
<td> (7)
</td>
<td class="t-sdsc-nopad">
</td></tr>



<tr>
<td colspan="10" class="t-sdsc-sep">
</td></tr>
<tr class="t-sdsc">
<td> <code><b>(</b></code> <span class="t-c"><span class="mw-geshi cpp source-cpp"><span class="kw4">char32_t</span></span></span> <code><b>)</b></code>
</td>
<td> (8)
</td>
<td class="t-sdsc-nopad">
</td></tr>



<tr>
<td colspan="10" class="t-sdsc-sep">
</td></tr>
<tr class="t-sdsc">
<td> <code><b>(</b></code> <span class="t-c"><span class="mw-geshi cpp source-cpp"><span class="kw4">const</span> <span class="kw4">char</span> <span class="sy2">*</span></span></span> <code><b>,</b></code> <span class="t-c"><span class="mw-geshi cpp source-cpp"><a href="../types/size_t.html"><span class="kw100">std::<span class="me2">size_t</span></span></a></span></span> <code><b>)</b></code>
</td>
<td> (9)
</td>
<td class="t-sdsc-nopad">
</td></tr>



<tr>
<td colspan="10" class="t-sdsc-sep">
</td></tr>
<tr class="t-sdsc">
<td> <code><b>(</b></code> <span class="t-c"><span class="mw-geshi cpp source-cpp"><span class="kw4">const</span> <span class="kw4">wchar_t</span> <span class="sy2">*</span></span></span> <code><b>,</b></code> <span class="t-c"><span class="mw-geshi cpp source-cpp"><a href="../types/size_t.html"><span class="kw100">std::<span class="me2">size_t</span></span></a></span></span> <code><b>)</b></code>
</td>
<td> (10)
</td>
<td class="t-sdsc-nopad">
</td></tr>



<tr>
<td colspan="10" class="t-sdsc-sep">
</td></tr>
<tr class="t-sdsc">
<td> <code><b>(</b></code> <span class="t-c"><span class="mw-geshi cpp source-cpp"><span class="kw4">const</span> char8_t <span class="sy2">*</span></span></span> <code><b>,</b></code> <span class="t-c"><span class="mw-geshi cpp source-cpp"><a href="../types/size_t.html"><span class="kw100">std::<span class="me2">size_t</span></span></a></span></span> <code><b>)</b></code>
</td>
<td> (11)
</td>
<td> <span class="t-mark-rev t-since-cxx20">(C++20 起)</span>
</td></tr>



<tr>
<td colspan="10" class="t-sdsc-sep">
</td></tr>
<tr class="t-sdsc">
<td> <code><b>(</b></code> <span class="t-c"><span class="mw-geshi cpp source-cpp"><span class="kw4">const</span> <span class="kw4">char16_t</span> <span class="sy2">*</span></span></span> <code><b>,</b></code> <span class="t-c"><span class="mw-geshi cpp source-cpp"><a href="../types/size_t.html"><span class="kw100">std::<span class="me2">size_t</span></span></a></span></span> <code><b>)</b></code>
</td>
<td> (12)
</td>
<td class="t-sdsc-nopad">
</td></tr>



<tr>
<td colspan="10" class="t-sdsc-sep">
</td></tr>
<tr class="t-sdsc">
<td> <code><b>(</b></code> <span class="t-c"><span class="mw-geshi cpp source-cpp"><span class="kw4">const</span> <span class="kw4">char32_t</span> <span class="sy2">*</span></span></span> <code><b>,</b></code> <span class="t-c"><span class="mw-geshi cpp source-cpp"><a href="../types/size_t.html"><span class="kw100">std::<span class="me2">size_t</span></span></a></span></span> <code><b>)</b></code>
</td>
<td> (13)
</td>
<td class="t-sdsc-nopad">
</td></tr>



<tr>
<td colspan="10" class="t-sdsc-sep">
</td></tr></table>
<div class="t-li1"><span class="t-li">1)</span> 拥有此形参列表的字面量运算符是<i>原始字面量运算符</i>，用于整数和浮点用户定义字面量的后备方式（见上文）</div>
<div class="t-li1"><span class="t-li">2)</span> 拥有这些形参列表的字面量运算符是用户定义整数字面量的首选字面量运算符</div>
<div class="t-li1"><span class="t-li">3)</span> 拥有这些形参列表的字面量运算符是用于定义浮点字面量的首选字面量运算符</div>
<div class="t-li1"><span class="t-li">4-8)</span> 拥有这些形参列表的字面量运算符由用户定义的字符字面量所调用</div>
<div class="t-li1"><span class="t-li">9-13)</span> 拥有这些形参列表的字面量运算符由用户定义的字符串字面量所调用</div>
<p>不允许<a href="default_arguments.html" title="cpp/language/default arguments">默认实参</a>
</p><p>不允许 C <a href="language_linkage.html" title="cpp/language/language linkage">语言连接</a>
</p><p>除了上述限制外，字面量运算符和字面量运算符模板都是普通的函数（和函数模板），它们可声明为 inline 或 constexpr，它们可拥有内部或外部连接，它们可显式调用，可取其地址，等等。
</p>
<div dir="ltr" class="mw-geshi" style="text-align: left;"><div class="cpp source-cpp"><pre class="de1"><span class="kw4">void</span> operator <span class="st0">""</span> _km<span class="br0">(</span><span class="kw4">long</span> <span class="kw4">double</span><span class="br0">)</span><span class="sy4">;</span> <span class="co1">// OK ，将为 1.0_km 所调用</span>
<a href="../string/basic_string.html"><span class="kw1230">std::<span class="me2">string</span></span></a> operator <span class="st0">""</span> _i18n<span class="br0">(</span><span class="kw4">const</span> <span class="kw4">char</span><span class="sy2">*</span>, <a href="../types/size_t.html"><span class="kw100">std::<span class="me2">size_t</span></span></a><span class="br0">)</span><span class="sy4">;</span> <span class="co1">// OK</span>
<span class="kw1">template</span> <span class="sy1">&lt;</span><span class="kw4">char</span>...<span class="sy1">&gt;</span> <span class="kw4">double</span> operator <span class="st0">""</span> _π<span class="br0">(</span><span class="br0">)</span><span class="sy4">;</span> <span class="co1">// OK</span>
<span class="kw4">float</span> operator <span class="st0">""</span>_e<span class="br0">(</span><span class="kw4">const</span> <span class="kw4">char</span><span class="sy2">*</span><span class="br0">)</span><span class="sy4">;</span> <span class="co1">// OK</span>
 
<span class="kw4">float</span> operator <span class="st0">""</span>Z<span class="br0">(</span><span class="kw4">const</span> <span class="kw4">char</span><span class="sy2">*</span><span class="br0">)</span><span class="sy4">;</span> <span class="co1">// 错误：后缀必须以下划线开始</span>
<span class="kw4">double</span> operator<span class="st0">""</span> _Z<span class="br0">(</span><span class="kw4">long</span> <span class="kw4">double</span><span class="br0">)</span><span class="sy4">;</span> <span class="co1">// 错误：所有以下划线后随大写字母开始的名称受到保留</span>
<span class="kw4">double</span> operator<span class="st0">""</span>_Z<span class="br0">(</span><span class="kw4">long</span> <span class="kw4">double</span><span class="br0">)</span><span class="sy4">;</span> <span class="co1">// OK：虽然 _Z 被保留，但允许 ""_Z</span></pre></div></div>
<h3><span class="mw-headline" id=".E6.B3.A8.E8.A7.A3">注解</span></h3>
<p>自从引入用户定义字面量之后，使用<a href="../types/integer.html" title="cpp/types/integer">定宽整数类型格式化宏常量</a>却不在前导字符串字面量后加空格变为非法：<span class="t-c"><span class="mw-geshi cpp source-cpp"><a href="../io/c/fprintf.html"><span class="kw1845">std::<span class="me2">printf</span></span></a><span class="br0">(</span><span class="st0">"%"</span><a href="../types/integer.html"><span class="kw179">PRId64</span></a><span class="st0">"<span class="es1">\n</span>"</span>,<a href="../types/integer.html"><span class="kw137">INT64_MIN</span></a><span class="br0">)</span><span class="sy4">;</span></span></span> 必须替换成 <span class="t-c"><span class="mw-geshi cpp source-cpp"><a href="../io/c/fprintf.html"><span class="kw1845">std::<span class="me2">printf</span></span></a><span class="br0">(</span><span class="st0">"%"</span> <a href="../types/integer.html"><span class="kw179">PRId64</span></a><span class="st0">"<span class="es1">\n</span>"</span>,<a href="../types/integer.html"><span class="kw137">INT64_MIN</span></a><span class="br0">)</span><span class="sy4">;</span></span></span>
</p><p>由于<a href="translation_phases.html#.E6.9C.80.E5.A4.A7.E5.90.9E.E5.99.AC" title="cpp/language/translation phases">最大吞噬规则</a>，以 <span class="t-rev-inl t-since-cxx17"><span><code>p</code>、<code>P</code>、</span> <span><span class="t-mark-rev t-since-cxx17">(C++17 起)</span></span></span>{tt|e}} 和 <code>E</code> 结束的用户定义整数和浮点字面量，在后随运算符 <code>+</code> 或 <code>-</code> 时，必须在源码中以空白符或括号与运算符分隔：
</p>
<div dir="ltr" class="mw-geshi" style="text-align: left;"><div class="cpp source-cpp"><pre class="de1"><span class="kw4">long</span> <span class="kw4">double</span> operator<span class="st0">""</span>_E<span class="br0">(</span><span class="kw4">long</span> <span class="kw4">double</span><span class="br0">)</span><span class="sy4">;</span>
<span class="kw4">long</span> <span class="kw4">double</span> operator<span class="st0">""</span>_a<span class="br0">(</span><span class="kw4">long</span> <span class="kw4">double</span><span class="br0">)</span><span class="sy4">;</span>
<span class="kw4">int</span> operator<span class="st0">""</span>_p<span class="br0">(</span><span class="kw4">unsigned</span> <span class="kw4">long</span> <span class="kw4">long</span><span class="br0">)</span><span class="sy4">;</span>
 
<span class="kw4">auto</span> x <span class="sy1">=</span> <span class="nu16">1.0</span>_E<span class="sy2">+</span><span class="nu16">2.0</span><span class="sy4">;</span>   <span class="co1">// 错误</span>
<span class="kw4">auto</span> y <span class="sy1">=</span> <span class="nu16">1.0</span>_a<span class="sy2">+</span><span class="nu16">2.0</span><span class="sy4">;</span>   <span class="co1">// OK</span>
<span class="kw4">auto</span> z <span class="sy1">=</span> <span class="nu16">1.0</span>_E <span class="sy2">+</span><span class="nu16">2.0</span><span class="sy4">;</span>  <span class="co1">// OK</span>
<span class="kw4">auto</span> q <span class="sy1">=</span> <span class="br0">(</span><span class="nu16">1.0</span>_E<span class="br0">)</span><span class="sy2">+</span><span class="nu16">2.0</span><span class="sy4">;</span> <span class="co1">// OK</span>
<span class="kw4">auto</span> w <span class="sy1">=</span> <span class="nu0">1</span>_p<span class="sy2">+</span><span class="nu0">2</span><span class="sy4">;</span>       <span class="co1">// 错误</span>
<span class="kw4">auto</span> u <span class="sy1">=</span> <span class="nu0">1</span>_p <span class="sy2">+</span><span class="nu0">2</span><span class="sy4">;</span>      <span class="co1">// OK</span></pre></div></div>
<p>同样的规则适用于后随整数或浮点用户定义字面量的点运算符：
</p>
<div dir="ltr" class="mw-geshi" style="text-align: left;"><div class="cpp source-cpp"><pre class="de1"><span class="co2">#include &lt;chrono&gt;</span>
<span class="kw1">using</span> <span class="kw1">namespace</span> std<span class="sy4">::</span><span class="me2">literals</span><span class="sy4">;</span>
<span class="kw4">auto</span> a <span class="sy1">=</span> 4s.<span class="me1">count</span><span class="br0">(</span><span class="br0">)</span><span class="sy4">;</span>   <span class="co1">// 错误</span>
<span class="kw4">auto</span> b <span class="sy1">=</span> 4s .<span class="me1">count</span><span class="br0">(</span><span class="br0">)</span><span class="sy4">;</span>  <span class="co1">// OK</span>
<span class="kw4">auto</span> c <span class="sy1">=</span> <span class="br0">(</span>4s<span class="br0">)</span>.<span class="me1">count</span><span class="br0">(</span><span class="br0">)</span><span class="sy4">;</span> <span class="co1">// OK</span></pre></div></div>
<p>否则会组成单个非法预处理数字记号（例如 <span class="t-c"><span class="mw-geshi cpp source-cpp"><span class="nu16">1.0</span>_E<span class="sy2">+</span><span class="nu16">2.0</span></span></span> 或 <span class="t-c"><span class="mw-geshi cpp source-cpp">4s.<span class="me1">count</span></span></span>），这导致编译失败。
</p>
<h3><span class="mw-headline" id=".E7.A4.BA.E4.BE.8B">示例</span></h3>
<div class="t-example"><div class="t-example-live-link"><div class="coliru-btn coliru-btn-run-init">运行此代码</div></div>
<div dir="ltr" class="mw-geshi" style="text-align: left;"><div class="cpp source-cpp"><pre class="de1"><span class="co2">#include &lt;iostream&gt;</span>
 
<span class="co1">// 用于转换</span>
<span class="kw4">constexpr</span> <span class="kw4">long</span> <span class="kw4">double</span> operator<span class="st0">""</span> _deg <span class="br0">(</span> <span class="kw4">long</span> <span class="kw4">double</span> deg <span class="br0">)</span>
<span class="br0">{</span>
    <span class="kw1">return</span> deg <span class="sy2">*</span> 3.14159265358979323846264L <span class="sy2">/</span> <span class="nu0">180</span><span class="sy4">;</span>
<span class="br0">}</span>
 
<span class="co1">// 用于自定义类型</span>
<span class="kw1">struct</span> mytype
<span class="br0">{</span>
    <span class="kw4">unsigned</span> <span class="kw4">long</span> <span class="kw4">long</span> m<span class="sy4">;</span>
<span class="br0">}</span><span class="sy4">;</span>
<span class="kw4">constexpr</span> mytype operator<span class="st0">""</span> _mytype <span class="br0">(</span> <span class="kw4">unsigned</span> <span class="kw4">long</span> <span class="kw4">long</span> n <span class="br0">)</span>
<span class="br0">{</span>
    <span class="kw1">return</span> mytype<span class="br0">{</span>n<span class="br0">}</span><span class="sy4">;</span>
<span class="br0">}</span>
 
<span class="co1">// 用作副作用</span>
<span class="kw4">void</span> operator<span class="st0">""</span> _print <span class="br0">(</span> <span class="kw4">const</span> <span class="kw4">char</span><span class="sy2">*</span> str <span class="br0">)</span>
<span class="br0">{</span>
    <a href="../io/cout.html"><span class="kw1758">std::<span class="me2">cout</span></span></a> <span class="sy1">&lt;&lt;</span> str<span class="sy4">;</span>
<span class="br0">}</span>
 
<span class="kw4">int</span> main<span class="br0">(</span><span class="br0">)</span><span class="br0">{</span>
    <span class="kw4">double</span> x <span class="sy1">=</span> <span class="nu16">90.0</span>_deg<span class="sy4">;</span>
    <a href="../io/cout.html"><span class="kw1758">std::<span class="me2">cout</span></span></a> <span class="sy1">&lt;&lt;</span> <a href="../io/manip/fixed.html"><span class="kw1784">std::<span class="me2">fixed</span></span></a> <span class="sy1">&lt;&lt;</span> x <span class="sy1">&lt;&lt;</span> <span class="st0">'<span class="es1">\n</span>'</span><span class="sy4">;</span>
    mytype y <span class="sy1">=</span> <span class="nu0">123</span>_mytype<span class="sy4">;</span>
    <a href="../io/cout.html"><span class="kw1758">std::<span class="me2">cout</span></span></a> <span class="sy1">&lt;&lt;</span> y.<span class="me1">m</span> <span class="sy1">&lt;&lt;</span> <span class="st0">'<span class="es1">\n</span>'</span><span class="sy4">;</span>
    <span class="nu12">0x123ABC</span>_print<span class="sy4">;</span>
<span class="br0">}</span></pre></div></div>
<p>输出：
</p>
<div dir="ltr" class="mw-geshi" style="text-align: left;"><div class="text source-text"><pre class="de1">1.570796
123
0x123ABC</pre></div></div> 
</div>
<h3><span class="mw-headline" id=".E6.A0.87.E5.87.86.E5.BA.93">标准库</span></h3>
<p>标准库中定义了下列字面量运算符
</p>
<table class="t-dsc-begin">

<tr class="t-dsc-header">
<td colspan="2"> <div>定义于内联命名空间 <code>std::literals::complex_literals</code></div>
</td></tr>

<tr class="t-dsc">
<td>  <div class="t-dsc-member-div"><div><a href="../numeric/complex/operator%2522%2522i.html" title='cpp/numeric/complex/operator""i'> <span class="t-lines"><span>operator""if</span><span>operator""i</span><span>operator""il</span></span></a></div><div><span class="t-lines"><span><span class="t-mark-rev t-since-cxx14">(C++14)</span></span></span></div></div>
</td>
<td>  表示纯虚数的 <span class="t-lc"><a href="../numeric/complex.html" title="cpp/numeric/complex">std::complex</a></span> 字面量 <br> <span class="t-mark">(函数)</span> </td></tr>

<tr class="t-dsc-header">
<td colspan="2"> <div>定义于内联命名空间 <code>std::literals::chrono_literals</code></div>
</td></tr>

<tr class="t-dsc">
<td>  <div class="t-dsc-member-div"><div><a href="../chrono/operator%2522%2522h.html" title='cpp/chrono/operator""h'> <span class="t-lines"><span>operator""h</span></span></a></div><div><span class="t-lines"><span><span class="t-mark-rev t-since-cxx14">(C++14)</span></span></span></div></div>
</td>
<td>  表示小时的 <span class="t-lc"><a href="../chrono/duration.html" title="cpp/chrono/duration">std::chrono::duration</a></span> 字面量 <br> <span class="t-mark">(函数)</span> </td></tr>

<tr class="t-dsc">
<td>  <div class="t-dsc-member-div"><div><a href="../chrono/operator%2522%2522min.html" title='cpp/chrono/operator""min'> <span class="t-lines"><span>operator""min</span></span></a></div><div><span class="t-lines"><span><span class="t-mark-rev t-since-cxx14">(C++14)</span></span></span></div></div>
</td>
<td>  表示分钟的 <span class="t-lc"><a href="../chrono/duration.html" title="cpp/chrono/duration">std::chrono::duration</a></span> 字面量 <br> <span class="t-mark">(函数)</span> </td></tr>

<tr class="t-dsc">
<td>  <div class="t-dsc-member-div"><div><a href="../chrono/operator%2522%2522s.html" title='cpp/chrono/operator""s'> <span class="t-lines"><span>operator""s</span></span></a></div><div><span class="t-lines"><span><span class="t-mark-rev t-since-cxx14">(C++14)</span></span></span></div></div>
</td>
<td>  表示秒的 <span class="t-lc"><a href="../chrono/duration.html" title="cpp/chrono/duration">std::chrono::duration</a></span> 字面量 <br> <span class="t-mark">(函数)</span> </td></tr>

<tr class="t-dsc">
<td>  <div class="t-dsc-member-div"><div><a href="../chrono/operator%2522%2522ms.html" title='cpp/chrono/operator""ms'> <span class="t-lines"><span>operator""ms</span></span></a></div><div><span class="t-lines"><span><span class="t-mark-rev t-since-cxx14">(C++14)</span></span></span></div></div>
</td>
<td>  表示毫秒的 <span class="t-lc"><a href="../chrono/duration.html" title="cpp/chrono/duration">std::chrono::duration</a></span> 字面量 <br> <span class="t-mark">(函数)</span> </td></tr>

<tr class="t-dsc">
<td>  <div class="t-dsc-member-div"><div><a href="../chrono/operator%2522%2522us.html" title='cpp/chrono/operator""us'> <span class="t-lines"><span>operator""us</span></span></a></div><div><span class="t-lines"><span><span class="t-mark-rev t-since-cxx14">(C++14)</span></span></span></div></div>
</td>
<td>  表示微秒的 <span class="t-lc"><a href="../chrono/duration.html" title="cpp/chrono/duration">std::chrono::duration</a></span> 字面量 <br> <span class="t-mark">(函数)</span> </td></tr>

<tr class="t-dsc">
<td>  <div class="t-dsc-member-div"><div><a href="../chrono/operator%2522%2522ns.html" title='cpp/chrono/operator""ns'> <span class="t-lines"><span>operator""ns</span></span></a></div><div><span class="t-lines"><span><span class="t-mark-rev t-since-cxx14">(C++14)</span></span></span></div></div>
</td>
<td>  表示纳秒的 <span class="t-lc"><a href="../chrono/duration.html" title="cpp/chrono/duration">std::chrono::duration</a></span> 字面量 <br> <span class="t-mark">(函数)</span> </td></tr>

<tr class="t-dsc">
<td>  <div class="t-dsc-member-div"><div><a href="../chrono/operator%2522%2522y.html" title='cpp/chrono/operator""y'> <span class="t-lines"><span>operator""y</span></span></a></div><div><span class="t-lines"><span><span class="t-mark-rev t-since-cxx20">(C++20)</span></span></span></div></div>
</td>
<td>  表示特定年的 <span class="t-lc">std::chrono::year</span> 字面量 <br> <span class="t-mark">(函数)</span> </td></tr>

<tr class="t-dsc">
<td>  <div class="t-dsc-member-div"><div><a href="../chrono/operator%2522%2522d.html" title='cpp/chrono/operator""d'> <span class="t-lines"><span>operator""d</span></span></a></div><div><span class="t-lines"><span><span class="t-mark-rev t-since-cxx20">(C++20)</span></span></span></div></div>
</td>
<td>  表示月内日期的 <span class="t-lc">std::chrono::day</span> 字面量 <br> <span class="t-mark">(函数)</span> </td></tr>

<tr class="t-dsc-header">
<td colspan="2"> <div>定义于内联命名空间 <code>std::literals::string_literals</code></div>
</td></tr>

<tr class="t-dsc">
<td>  <div class="t-dsc-member-div"><div><a href="../string/basic_string/operator%2522%2522s.html" title='cpp/string/basic string/operator""s'> <span class="t-lines"><span>operator""s</span></span></a></div><div><span class="t-lines"><span><span class="t-mark-rev t-since-cxx14">(C++14)</span></span></span></div></div>
</td>
<td>  转换字符数组字面量为 <code>basic_string</code> <br> <span class="t-mark">(函数)</span> </td></tr>

<tr class="t-dsc-header">
<td colspan="2"> <div>定义于内联命名空间 <code>std::literals::string_view_literals</code></div>
</td></tr>

<tr class="t-dsc">
<td>  <div class="t-dsc-member-div"><div><a href="../string/basic_string_view/operator%2522%2522sv.html" title='cpp/string/basic string view/operator""sv'> <span class="t-lines"><span>operator""sv</span></span></a></div><div><span class="t-lines"><span><span class="t-mark-rev t-since-cxx17">(C++17)</span></span></span></div></div>
</td>
<td>  创建一个字符数组字面量的字符串视图 <br> <span class="t-mark">(函数)</span> </td></tr>
</table>

<!-- 
NewPP limit report
Preprocessor visited node count: 6048/1000000
Preprocessor generated node count: 11162/1000000
Post‐expand include size: 148201/2097152 bytes
Template argument size: 35634/2097152 bytes
Highest expansion depth: 20/40
Expensive parser function count: 0/100
-->

<!-- Saved in parser cache with key mwiki1-mwiki_zh_:pcache:idhash:2765-0!*!0!!zh!*!zh!* and timestamp 20190831110910 -->
</div>                    <!-- /bodycontent -->
                                        <!-- printfooter -->
                    <div class="printfooter">
                    来自“<a href="https://zh.cppreference.com/mwiki/index.php?title=cpp/language/user_literal&amp;oldid=60202">https://zh.cppreference.com/mwiki/index.php?title=cpp/language/user_literal&amp;oldid=60202</a>”                    </div>
                    <!-- /printfooter -->
                                                            <!-- catlinks -->
                    <!-- /catlinks -->
                                                            <div class="visualClear"></div>
                    <!-- debughtml -->
                                        <!-- /debughtml -->
                </div>
                <!-- /bodyContent -->
            </div>
        </div>
        <!-- /content -->
        <!-- footer -->
        <div id="cpp-footer-base" class="noprint">
            <div id="footer">
                        <div id="cpp-navigation">
            <h5>导航</h5>
            <ul><li><a href="https://zh.cppreference.com/w/cpp/language/user_literal">Online version</a></li><li>Offline version retrieved 2020-03-14 18:00.</li></ul></div>
                        <ul id="footer-info">
                                    <li id="footer-info-lastmod"> 本页面最后修改于2019年5月3日 (星期五) 22:23。</li>
                                    <li id="footer-info-viewcount">此页面已被浏览过11,183次。</li>
                            </ul>
                    </div>
        </div>
        <!-- /footer -->
        <script>if(window.mw){
mw.loader.state({"site":"loading","user":"missing","user.groups":"ready"});
}</script>
<script src="../../../common/skin_scripts.js"></script>
<script>if(window.mw){
mw.loader.load(["mediawiki.action.view.postEdit","mediawiki.user","mediawiki.page.ready","mediawiki.searchSuggest","mediawiki.hidpi","ext.gadget.MathJax","ext.gadget.ColiruCompiler"], null, true);
}</script>
<script src="../../../common/site_scripts.js"></script>
<script type="text/javascript">
var _gaq = _gaq || [];
_gaq.push(['_setAccount', 'UA-2828341-1']);
_gaq.push(['_setDomainName', 'cppreference.com']);
_gaq.push(['_trackPageview']);
</script><!-- Served in 3.345 secs. -->
	</body>
<!-- Cached 20190831110910 -->
</html>